home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / ptolemy / troubles < prev   
Text File  |  1993-07-26  |  7KB  |  169 lines
  1. Trouble Shooting Ptolemy
  2. ------------------------
  3.  
  4.      This section is a collection common difficulties encountered
  5. when  ptolemy is installed.  This list is, of course, by no means
  6. complete.  If you can't find your particular problem here,  refer
  7. to "Additional Resources" at the end of this section.
  8.  
  9. 1. Permission Denied
  10.  
  11.      If when you start  pigi  you  get  the  message  "permission
  12. denied" and the Ptolemy greeting window fails to pop up, then Vem
  13. was unable to start  pigiRpc,  the  associated  Ptolemy  process.
  14. This  process is started using the Unix "rsh" command.  This com-
  15. mand can fail  if  your  workstation  does  not  have  networking
  16. enabled,  or the user's .rhosts file does not include the name of
  17. the workstation on which you are running.  The  following  simple
  18. test checks your networking and .rhosts configuration:
  19.  
  20.             rsh name echo "hello world"
  21.  
  22. where "name" is the name of your workstation.  If  you  get  back
  23. "hello  world",  then your workstation networking is correct.  If
  24. you get the "permission denied" message again, then  either  your
  25. .rhosts is incorrect or networking is turned off on your worksta-
  26. tion.  If the latter is  the  problem,  please  ask  your  system
  27. administrator to enable networking.
  28.  
  29. 2. Graphs Fail to appear
  30.  
  31.      If you succeed in invoking pigi, but graphs do  not  appear,
  32. but  messages  saying  that the xgraph program could not be found
  33. appear instead, your path is set incorrectly.  Because pigi  uses
  34. rsh to start up Ptolemy, your path must be defined in you .cshrc
  35. file, not just in your .login file.  This path must be defined
  36. even when "prompt" is not set, since your .cshrc file will be
  37. read in non-interactive mode.
  38.  
  39. 3. Ptolemy won't recompile
  40.  
  41.      You may be using a substantially different  version  of  the
  42. Gnu  compiler.  The system is most likely to build if you use the
  43. same tools that we used originally.  The gnu tools  we  used  are
  44. supplied with the Ptolemy distribution.
  45.  
  46. 4. Old Flowgraphs won't work.
  47.  
  48.      Several stars that were included in  the  0.3.1  release  of
  49. Ptolemy  have  been  renamed.  The  objective was to adopt a con-
  50. sistent naming policy across all domains. One  major  benefit  of
  51. this  is  the  ability to migrate universes and galaxies from one
  52. domain to another. A consequence, however, is that some  of  your
  53. universes and galaxies will have inconsistencies (they will point
  54. to icons that no longer exist in the  current  release).   Please
  55. see  the  file  "$PTOLEMY/lib/rename/README."  This file explains
  56. how to  upgrade  your  universes  and  galaxies  to  the  current
  57. release.
  58.  
  59. 5. Error: ld.so: libXext.so.4: not found
  60.  
  61.      You have not installed the shared library needed by  Ptolemy
  62. when  it is used under Open Windows.  See the "Open Windows" sec-
  63. tion in the installation guide.
  64.  
  65. 6. Error, Cannot create wormhole a Code Generation Domain.
  66.  
  67. When you use a galaxy, there are two conditions that can cause a
  68. wormhole to form: either the Domain is different on the inside
  69. and the outside, or the Target is different.  In the Ptolemy 0.4
  70. release, we do not yet support the latter case in any domain.
  71. So the Target inside any galaxy should be <parent>.  Unfortunately,
  72. if it isn't <parent>, Ptolemy will not even make an icon for it.
  73.  
  74. So the error will typically occur as follows:
  75.  
  76. You develop a Universe, choose a Target, change its parameters,
  77. and test the Universe.  Happy that it works, you replace the I/O
  78. stars with terminals to turn it into a Galaxy.  Now you try to make
  79. an icon, and Ptolemy complains:
  80.    Error: No wormhole implemented for domain CGC
  81. The problem is that the Target is not <parent>.
  82. Set the Target to <parent>, and then you can make an icon
  83. and use it in the expected way.
  84.  
  85. 7. Black and White Monitors
  86.  
  87. Although Ptolemy was written with color monitors in mind, it is possible
  88. to run the GUI with a black and white monitor.  Before running pigi,
  89. do the following command:
  90.  
  91. setenv PIGIBW
  92.  
  93. This will set up the color map so that the icons will be readable in
  94. black and white.  
  95.  
  96. 8. Error involving "xedit"
  97.  
  98. Xedit is a program provided with Ptolemy to display files on your
  99. screen during a Ptolemy run.  If there is some problem with xedit
  100. that you cannot solve, or you do not like xedit, it is possible to
  101. change the display program used by Ptolemy.  To do this, you need
  102. to set the PT_DISPLAY environment variable before you run pigi.
  103. For example, to use PT_DISPLAY to view files in a new xterm window 
  104. with the vi editor, do
  105.  
  106. setenv PT_DISPLAY "xterm -e vi %s"
  107.  
  108. The value of the PT_DISPLAY variable is a printf format string with 
  109. one %s in it.  That %s is replaced with the file to be viewed, for 
  110. look-inside commands and to view generated code.  The default value 
  111. is "xedit %s".
  112.  
  113. 9. "Inconsistent facet" error when starting pigi
  114.  
  115. The following error message comes up upon starting pigi:
  116.      ----------------------------------------
  117.      This is VEM version 8-1 (made 28-Feb-91)
  118.      Log file is /dev/null
  119.      Reading cell init.pal:schematic:contents...Inconsistent facet `init.pal:sc
  120.      hematic'
  121.      Use the program `inconsistent' to find the problem
  122.      and the program `octmvlib' to fix it.
  123.      Then you can try to open the facet again.
  124.      Could not open new window
  125.      done
  126.      ----------------------------------------
  127.  
  128. This is caused by a errant pointer in your the init.pal facet is the 
  129. directory where you started pigi.  The simple (but ugly) solution is
  130. to delete or move init.pal and re-start pigi.  Alternatively, you can
  131. try to fix init.pal with the masters program.  Details on the masters
  132. program may be found in $PTOLEMY/src/utils/masters/doc/overall
  133.  
  134.  
  135. Additional Resources
  136. --------------------
  137.      The best, most complete source for information on Ptolemy is
  138. to  be  found  in  the PT manual, the Almagest.  Chances are, the
  139. information you are looking for is in there somewhere.
  140.  
  141.      The entire manual is included  in  every  distribution.  A post-
  142. script version of the manual is also available from the Ptolemy FTP
  143. site:  ptolemy.berkeley.edu.  In addition, the printed documentation 
  144. is also available from the ILP office at the following address:
  145.  
  146.             EECS/ERL Industrial Liaison Program Office
  147.             Software Distribution
  148.             479 Cory Hall
  149.             University of California, Berkeley
  150.             Berkeley, CA 94720
  151.             (510) 643-6687
  152.             email: software@hera.berkeley.edu
  153.  
  154. The current price is $50. US, but  that  is  subject  to  change.
  155. Contact them for the exact fee.
  156.  
  157.      A second source  is  the  "ptolemy-hackers@ohm.berkeley.edu"
  158. mailing  list.  This  list provides a forum for ptolemy questions
  159. and issues. Users of the current release who have a Ptolemy ques-
  160. tion,  comment,  or think they've found a bug should send mail to
  161. ptolemy-hackers.
  162.  
  163.      To join ptolemy-hackers, send mail to
  164. "ptolemy-hackers-request@ohm.berkeley.edu
  165. with the Subject "ADD ME."
  166.  
  167.      Another source is the Ptolemy ftp archive.  To access this,
  168. use anonymous FTP to ptolemy.berkeley.edu.
  169.